home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / exampleCode / opengl / README < prev   
Encoding:
Text File  |  1994-08-02  |  6.4 KB  |  143 lines
  1.  
  2.  
  3.                     toolbox/src/exampleCode/opengl README
  4.  
  5.     The executables in this opengl subtree were built on a 5.2 IRIX software
  6.     platform.  This code will NOT run on 5.0.1 or earlier Irix software.
  7.  
  8.        See the Frequently Asked Questions OpenGL file located at
  9.        ~4Dgifts/toolbox/FAQs/SGIfaqs/OpenGL-faq, as well as the 
  10.        ~4Dgifts/toolbox/documents/OpenGL tree of documentation.
  11.  
  12.     `!' indicates new or updated as of version 4.2
  13.  
  14.  
  15.   
  16.     This is the repository for openGL source code examples, libraries, 
  17.     documentation, etc.  The shape of this tree will no doubt keep 
  18.     changing, as things become more formalized.
  19.  
  20.  
  21.        bench:  contains dinomometer, a synthetic modeling benchmark for OpenGL
  22.  
  23.        cap:    opengl motif-based interference checking demo.
  24.  
  25.  !     colorChooser:  OpenGL Color Chooser Widget - libGLColorChooser.a.
  26.            contains the OpenGL version of the color chooser widget,
  27.            libGLColorChooser.a, which is identical in usage and 
  28.            functionality to the IRIS GL version of the color chooser 
  29.            widget found in libSgm.
  30.  
  31.        debugHelper:  provides a way to override DSO functions to trace a 
  32.                program's OpenGL calls w/out recompiling.
  33.  
  34.        motif:  contains sample openGL src based on MOTIF toolkit, libGLw.a, 
  35.                as well as straight libXm.so (see textfun).  new additions:
  36.                textfun:     the poor-man's OpenGL font manager
  37.                textfun5.1:  versions w/workaround for an IRIX 5.1 Motif bug
  38.                xmblur:      OpenGL motion blur demo
  39.  
  40.        nurbsTrim:  makes a trimmed NURBS surface in OpenGL and Inventor
  41.  
  42.  !     oat:    OpenGL Attribute Tester, or oat, is a program for testing the 
  43.            functionality of OpenGL on different platforms.  It provides a
  44.            GUI interface to test most (hopefully all) of the different
  45.            attributes that are changeable in OpenGL.
  46.  
  47.  !     pick:   implementation of picking in OpenGL including features of an X 
  48.            overlay on top of an RGBA, double- and depth- buffered window.
  49.  
  50.        utilities: 2 items from sgi's ftp site at sgi.com:  isfast contains
  51.                performance measure routines indicating if a given OpenGL 
  52.                feature is fast or not;  xglinfo displays information about 
  53.                an X server supporting the OpenGL extension, especially 
  54.                with regard to visuals.
  55.  
  56.        x+opengl:  contains a series of articles published in "The X Journal" 
  57.                about programming OpenGL and X, in PostScript -- "OpenGL and X,
  58.                Part 1: An Introduction," "Part 2: Using OpenGL with Xlib", and 
  59.                "OpenGL and X, Part 3:  Integrating OpenGL with Motif",
  60.                plus accompanying src files for progs discussed in each of the 
  61.            aritcles:  glxsimple.c, glxdino.c, glxmotif.c, paperplane.c + 
  62.  !             renderboth.c, in some measure, based on glxmotif.c
  63.  
  64.        xlib :  straight Xlib programs, specifically included to demonstrate 
  65.            programming independent of any toolkit, demonstrating a variety 
  66.            of OpenGL implementations for those who prefer/need to work on 
  67.            the level of stone knives and bearskins.
  68.                19 brand new ones, 4 updated, 38 total, including 2 implementing
  69.                commensurate "iris-GL-type" popup menu functionality.
  70.  
  71.        siggraphCD:  this is a slightly abbreviated and updated subtree of 
  72.                     the OpenGL CD given out at siggraph 1993.  newer 
  73.                     sections than the siggraphCD include more in the 
  74.                     lib/libtk directory, extra demos in src/demos 
  75.                     (atlantis, fadeflip, & stonehenge) and 3 extra 
  76.                     programs in src/examples/samples (cursor, overlay 
  77.                     & shape).  
  78.                     
  79.                     the siggraphCD subtree looks like this:
  80.  
  81.                                siggraphCD
  82.    
  83.                        /           /         \
  84.     
  85.                     lib          spec          src
  86.  
  87.                   /     \                /   /     /     \
  88.  
  89.              libaux{+}  libtk{+}     book libaux libtk   samples   
  90.                                         {+}    {+}   {+}       {+}
  91.  
  92.  {+} as of 5.2 IRIX, all these directories exist under /usr/share/src/OpenGL
  93.      when one loads the gl_dev.sw.oglsamples subsystem.  total size of this
  94.      subtree when loaded is 9.1MB
  95.  
  96.  
  97.  
  98.  libaux:  used by the programs in "book" and needs routines from libtk.  
  99.           libaux was written specifically for the "OpenGL Programming Guide"
  100.           book (see "book" description below) to make programming examples
  101.           simpler yet more complete.
  102.  
  103.  libGLw:  in previous editions of the Toolbox, we included the Motif widget 
  104.           for OpenGL but the Makefiles in the opengl subtree have long since 
  105.           all been changed to refer to -lGLw and /usr/include/GL for the 
  106.           actual compiles they perform.  We have since removed the libGLw 
  107.           directory that was in the siggraphCD/lib subtree.  One can still 
  108.           examine the actual widget source by loading the gl_dev.sw.oglsamples
  109.           subsystem and going to the /usr/share/src/OpenGL/libwidget 
  110.           subdirectory.
  111.  
  112.  libtk:   provides simple windowing functions, event handling, & extras like
  113.           cursor control, simple geometric shape creations, fonts, etc.  It 
  114.           is built without any toolkit or widget and relies soley on Xlib.
  115.  
  116.  spec:   contains PostScript files comprising the OpenGL specification:
  117.          GLUspec.ps:  The OpenGL Graphics System Utility Library;
  118.          GLXspec.ps:  OpenGL Graphics with the X Window System (Version 1.0);
  119.          GLspec.ps:  The OpenGL Graphics System:  A Specification (Version 1.0)
  120.  
  121.  demos:  the demos tree has moved to src/demos/OpenGL
  122.  
  123.  book:   contains on-line versions of all src described in "The OpenGL 
  124.          Programming Guide," Addison-Wesley, ISBN 0-201-63274-8.
  125.  
  126.  samples:  contains examples based on libtk
  127.  
  128.  
  129.  uses libaux:  siggraphCD/src/book
  130.  
  131.  uses libGLw:  motif
  132.                ../../src/demos/OpenGL/backtrace
  133.                ../../src/demos/OpenGL/stonehenge
  134.  
  135.  uses libtk:   siggraphCD/lib/libaux
  136.                siggraphCD/src/samples
  137.                ../../src/demos/OpenGL/atlantis
  138.                ../../src/demos/OpenGL/backtrace
  139.                ../../src/demos/OpenGL/insect
  140.                ../../src/demos/OpenGL/lorenz
  141.                ../../src/demos/OpenGL/puzzle
  142.                ../../src/demos/OpenGL/stonehenge
  143.